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PREFACE 


This manual describes the resident Operating System <QS> for the 
ATARIS Home Computer^ for readers who are familiär with the 
internal behavior of the System. It discusses: 

o System functions and utilization techniques 

o Subsystem re lationships and Organization 

o Characteristics of the ATARI peripheral devices that can 

be attached to the ATARI400CTM3 and ATARI BOÖCTM] Home 
Computer 

o Advanced techniques for going beyond the basic OS 
capabi1ities 

o The general features of the Computer System hardware used 
by the OS. 

It uiould be helpful to have a familiarity with programming concepts 
and terminology f assembly language programming in generalr the 
Synertek 6502 in particular ( and digital hardware concepts and 
terminology. you will be provided with the Information you need to 
use the OS resources/ without resorting to trial-and-error techniques 
or the OS listing. Supporting Information for tasks that involve OS 
listing references is also provided. 

This manual does not present a comprehensive description of the 
hardware used to provide OS capabilites. The programmer who needs to 
go beyond the capabilities described should consult the ATARI Home 
Computer Hardware Manual. 
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1 INTRODUCTIQN 


GENERAL DESCRIPTION ÜF THE ATARI HOME COMPUTER SYSTEM 

Operating Systems in the ATARI® 400CTM3 and ATARI 8QOCTM3 Home 
Computer are identical. The primary differences b etween the tuio are 

o Physical packaging 

o The ATARI 400 Computer console has one cartridge slot* the 
ATARI 800 Computer console has two cartridge slots 

o The ATARI 400 Home Computer contains l&K RAM and cannot be 
expanded. The ATARI 800 Home Computer can be expanded to a 
maximum of 48K RAM. 

o The ATARI 800 Computer has a monitor jack; the ATARI 400 
Computer does not. 

The Hardware Circuitry 

o Produces both character and point graphics for black and 
white (B/W) or color television. 

o Produces four independent audio Channels (fre^uency 
controlled) uhich use the television sound System. 

o Provides one bi-level audio output in the base unit. 

o Interfaces uith up to four Joysticks and eight Paddle 
Controllers. 

o Interfaces with a serial I/ü bus for expansion. 
o Contains a built-in keyboard 

Figure 1-1 presents a simplified block diagram of the hardware. 

See the hardware manual for supporting documentation. 
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CONVENTIONS USED IN THIS MANUAL 


This manual uses the following special notations: 

Hexadecimal Numbers 

All tuo-digit numbers preceded by a dollar sign <$> designate 
hexadecimal numbers. All other numbers (except memory addresses) 
are in decimal form unless otherwise specified in the supporting 
text. 

Memory Addresses 

All references to Computer memory and mapped I/O locations are in 
hexadecimal notation. Memory addresses mag or mag not be contained 
in square brackets. (Example: CD20F1 and D2ÖF are the same 
address.) 

Kilobytes of Memory 

Memory sizes are frequently expressed in units of kilobytes/ such 
as 32K) where a kilobyte is 1024 bytes of memory. 


PASCAL As an Algorithm-Specification Language 

The PASCAL language {procedure block only) is used as the 
specification language in the feu places where an algorithm is 
specified in detail. PASCAL syntax is similar to any number of 
other block-structured languages* and you should have no 
difficulty following the code presented. 


Memory Layouts 

Diagrams similar to Figure 1—2 are used whenever pictures of bytes 
or tables are presented: 

76543210 

• > - This is a single byte. 

: : 

+ + - This is a ward <2 bytes). 

: ; 

; ; 

- = - This is a block of memory 

i ! of unspecified length. 

Figure 1-2, Memory Layout Chart 
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Bit 7 is the most signifieant bit (MSB) of the byte ( and Bit 0 
is ths least signifieant bit (LSB). 

In tables and figuresi ntemory addrssses alufays increase totuard the 
bottom of the f i gure. 


Backus-Naur Form 

A modified Version of Backus-Naur Form (8NF> is used to express some 
syntactic forms» tuh ere the fol lowing meta linguistic Symbols are used: 

::= is the Substitution (assignment) operator. 

< > a metasyntactic variable. 

! separates alternative substitutions. 

C 3 an optional construct. 

Anything eise is a syntactic literal constant» uihich Stands for 
itself. 

For Example: 

<devite specification> <device name>E<device number>3: 

<device name> ::» C!D!E!K!PiR!S 
<device number> ll2i3{4J5{6i7i8 


A "device specification“ consists of a mandatory “device name.“ 
followed by an optional "device numbert" followed by the mandatory 
colon character. The device name in turn must be one of the 
characters shotun as a 1 ternatives. The device number <if it is present) 
must be a digit 1 through 8, 


ÖS Equate Filenames 

Pperating System ROM (Read önly Memory) and RAM (Random Access 
Memory) vector names» RAM database variable names and hardware 
register names are all referred to by the names assigned in the OS 
program equate list. When one of these names is used» the memory 
address is usually provided, such as BOOTAD E02423. 
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2 OPERATING SYSTEM FUNCTIQNAL ORGANIZATION 


This section describes the various Subsystems of the resident OS in 
general terms. 

Input/Output Subsystem 

The Input/Output (I/O) Subsystem provides a high-level interface 
between the programs and the har d wäre. Most functions are 
device-independent« such as the reading and writing of character data; 
yet provisions have been made for device-dependent functions as weil. 
All peripheral devices capable of dealing with character data have 
individual symbolic names {such as K« D« P« etc), and can be accessed 
using a Central I/O (CIO) routine. 

A RAM data base provides access to Controllers (Joysticks and paddle 
Controllers)« which do not deal with character data. This RAM data 
base is periodically updated to Show the States of these devices. 


INTERRUPT PROCESSING 

The interrupt System handles all hardware interrupts in a common 
and consistent manner. By default« all interrupts are fielded by 
the OS. At your discretion« individual interrupts {or 
groups of interrupts) can be fielded by the application program. 


INITIALIZATION 

The System provides two levels of initialization: power up and 
system reset. The OS performs power-up initial i zation each time 
the system power is switched to ON« and System reset 
initia1ization is performed each time the CSYSTEM.RESET1 key is 
pressed. 

Power-Up 

The OS examines and notes the configuration of the unit whenever 
the system power is switched to ON. The system performs the following 
tasks at power up: 
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o Determines the highest RAM address, 
o Ciears all of RAM to leros. 
o Establishes all RAM Interrupt vectors. 

o Formats the device table. 

o Initializes the cartridge<s>. 

□ Sets up the screen for 24 x 40 text mode, 
o Boots the cassette if directed. 

o Checks Cartridge slot(s) for diskette-boot instructions. 

o Boots the diskette if directed to do so and a disk drive unit 
is attached. 

o Transfers control to the cartridge, diskette-booted program, 
cassette-booted program, or blackboard program. 

ESYSTEM.RESET3 

Pressing the CSYSTEM. RESET3 key causes the ÖS to perform these 
following tasks: 

o Ciears the OS portion of RAM. 
o Rechecks top of RAM. 

o Reestablishes all RAM interrupt vectors. 
o Formats the device table. 
o Initializes the cartridge<s>. 
o Sets up the screen for 24 x 40 text mode. 

o Transfers control to the cartridge, a diskette-booted program, 
a cassette-booted program, or the blackboard program, 

Note that [SYSTEM. RESET3 does not perform all the potner-up 
tasks listed in the power-up section. 
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FLOATING POINT ARITHMETIC PACKAGE 


The OS ROM contains a Floating Point (FP) pac kage that is availab 1e 
to nonresident programs such as ATARI BASIC. 

The package is not used by the other parts of the OS itself. The 
•Floating point numbers are stored as 10 BCD digits o-F mantissa. plus a 
1-byte exponent. The package contains these routines: 

o ASCII-to-FP and FP-to-ASCII conversion, 

o Integer—to-FP and FP-to-integer conversion. 


0 

FP 

add , 

subtract« 

multiply and divide. 

0 

FP 

1 og i 

exp ( and 

polynomial evaluation 

0 

FP 

number clear, 

loadt storei and move 
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3 CQNFIGURATIGNS 


The ATARI 400 and ATARI 8G0 Home Computers support a 

wide variety of configurations, each uith a unique operating 

environment: 

ü Cartridge(s) mag or may not be inserted 

o Memory can be optionallg added to the ATARI 8ÖÖ Computer 
consale in 16K increments 

d Mang different peripheTal deviees can be attached to the 
serial I/O bus. 


The OS accounts for all of these variables without requiring a 
change in the resident OS itself (see Section 2>. The machine 
configuration is checked tuhen potuer is first turned on and then 
is not checked again» unless System reset is used. A general 
discussion of some of the valid configurations follows. 


PROGRAM ENVIRONMENTS 


The OS allotifs one of four program types to be in control at any 
point in time: 

ü The OS blackboard (ATARI Memo Pad) program 


o A cartridge-resident program 
o A diskette-booted program 


o A cassette-booted program 


Control 
tuh ether 
inputs. 


choice is based upon Information in the cartridge(s ), upon 
or not a disk drive is attached» and upon operator kegboard 
The exact algorithms are discussed in detail in Section 7. 


Blackboard Mode 

In blackboard mode» the screen is established as a 24 x 40 text 
screen. Anything entered from the keyboard goes to the screen 
aiithout being examined» although all of the screen editing 
functions are supported. Blackboard mode is the 1 oufest priority 
environment. You go there only by command from a higher 
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priority environment. or by default. if there is no other 
reasonable environmsnt for the OS to enter. For example. typing BYE 
in BASIC causes the OS to enter the blackboard mode. The blackboard 
mode can be exited by pressing the ESYSTEM. RESET3 key if it Ufas 
entered from a higher environment. 


Cartridge 

An inserted cartridge normally provides the main control after 
initializatian is complete (for example: ATARI BASIC. SUPER 
BREAKOUTCTM3, BASKETBALL. COMPUTER CHESS, and others. All these 
cartridge programs interface directly with you in some way). Although 
a cartridge can provide a supporting function for some other program 
environment. this has not yet been done. Some cartridges (particular1y 
keyboard-oriented ones) can change environments by entering special 
commands (such as "BYE“) to go to blackboard mode or "DOS" to enter 
the disk utility. Other cartridges eannot change environments. Note 
that a hardware interlock prevents the removal or insertion of a 
cartridge with the power an. this feature causes the entire System to 
reinitialize with every cartridge change. 


Diskette Boot 

The diskette may or may not be booted when the System powers up 
with diskette-bootable Software. This paragraph assumes that a 
diskette boot did occur. See Section 7 for boot condition 
explanations. 

The diskette-booted Software can take control as the Disk Utility 
Program (DUP> does under certain conditions. or can provide a 
supporting function as the File Management System (FMS) does. This 
environment is so flexible that it is difficult to generalize on its 
capabilities and restrictions. The only machine reguirement (other 
than the disk drive) is that sufficient RAM be installed to support 
the program being booted. 


Cassette-Boot 

The cassette-boot environment is similar to the diskette-boot 
environment. although the cassette is limited as an I/O device. It 
is slow and can access only one file at ,a time in seguence. Note 
that the cassette-boot facility has no relation to the use of 
cassettes to störe high-level language programs (e.g.. programs 
written in ATARI BASIC), nor to the use of cassettes to störe data. 
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RAM EXPANSION 


Although you can expand RAM noncont iguous ly in the 
ATARI 800 Home Computer» the OS will only recognize RAM 
that is contiguous starting from Location G. Installation 
directions are provided with the purchased RAM modules. RAM can be 
added until it totale 48K. After 32K» additional RAM overlays first 
the right-cartridge addresses (32K to 40K> and then the 
1eft-cartridge addresses <40K to 4SK). Note that in cases of 
conflict» the inserted cartridge has higher priority and disables 
the conflicting RAM in 8K increments. See Section 4 for a detailed 
discussion of System memory. 

As a result of power-up» the OS will generate two pointers that 
define the lauest available RAM location and the highest available 
RAM location. The OS and diskette or cassette-booted Software will 
determine the location of the lowest available RAM» while the 
number of RAM modules and the current screen mode will determine 
the highest available RAM. 


PERIPHERAL DEVICES 

Peripheral devices of several types can be added to the System 
using Standard cables to either the serial bus or the connectors at 
the front of the Computer console. The most common types deal with 
either transmission of bytes of data <usually serial bus) or 
transmission of sense Information (usually game Controllers). 


Game Controllers 


The OS periodically senses <50 or 60 times per second) the Standard 
game Controllers <Paddles and Joysticks) and the values read are 
stored in RAM. You can plug in» remove» and rearrange these 


Controllers at will without affecting 
System will always try to read all of 
The Driving Controllers are read» but 
instructions are required to read the 
Section il). 


System Operation» because the 
these Controllers, 
not decoded» by the OS. Special 
keyboard Controller (see 


Program Recorder 

The ATARI 410CTM3 Program Recorder is a special peripheral. It uses 
the serial bus to send and receive data» but does not conform to 
the protocol of the other peripherals that use the serial bus. The 
Program Recorder must also be the last device on the serial bus» 
because it does not have a serial bus extender connector as the 
other peripherals do. There can never be more than one Program 
Recorder connected to any System for the same reason, The System 
cannot sense the presence or absence of the Program Recorder» so it 
can be connected and disconnected at will. 
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Serial Bus Devices 

A serial bus device conforms to the serial I/O bus protocol as 
defined in Section 9, but this does not include the Progratn 
Recorder. Each serial bus device has two identical connectors: a 
serial bus input, and a serial bus extender. Either connector can 
be used for either purpose. Peripherais can be "daisgchained" bg 
cabling thent together in a sepuential fashion. There are usuallg no 
restrictions on the cabling Order because each device has a uniq.ue 
identifier. Where restrictions exist, theg will be raentioned in 
Section 5, 
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4 SYSTEM MEMORY UTILIZATION 


Memory in the System is decoded in the full 64K ränge of the 6502 
mierocomputer and there are no provisions for additional mapping to 
extend memory. Memory is divided into four basic regions (with sonte 
overlap possible): RAM< Cartridge area< I/O region and the resident 
OS ROM. The regions and their address boundaries are listed below 
(all addresses are in hexadecima1): 


0000-1FFF — RAM (mi n imum reguired for Operation) 

2000-7FFF = RAM expansion area 

800Q-9FFF * Cartridge B/ Cartridge A (half of 16K size) or RAM 

AOOO-BFFF = Cartridge A or RAM 

CÖOO-CFFF - Unused 

D0ÖQ-D7FF =» Hardware I/O decodes 

D800-DFFF = Floating Point Package (OS) 

EÜOO=FFFF « Resident Operating System ROM 


Figure 4-1 6502 System Memory Map 

This seetian will break these regions into even smaller functional 
divisions and provide detailed explanations of their usage. 


RAM REGION 

The OS and the control program share the RAM region. The RAM region 
can be further subdivided into the following sub regions for 
discussion purposes: 

Page 0 - 6502 page zero address mode region. 

Page 1 « 6502 stack region. 

Pages 2-4 = ÖS database and user workspate. 

Pages 5-6 = User program uiorkspace. 

Pages 7-XX = Bootable Software area/free RAM. * 

Pages XX-top of RAM = Screen display list and data. * 

* Note that XX is a function of the screen graphics mode and the 
amount of RAM installed. 

The paragraphs that follow describe how the OS uses RAM subregions> 
and presents user program recomendations. 
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Page O 


The architecture of fche 6502 microcomputer instruction se t and 
addressing modes g i ves page O special significance, Referent es to 
addresses in that page (0000 to OOFF) are faster, require feiner 
instruction bytes, and provide the only mechanism for hardware 
indirect addressing. Page 0 should be used sparingly so that all 
possible users can have a portion of it. The OS permanently takes the 
lower half of page O <0000 to 0Ö7F). Th i s portion can never be used by 
any outer environment unless the OS is completely disabled and all 
interrupts to the OS are eliminated. 


The upper half of 
environments with 
package, if used, 


page 0 (0080 to OOFF) is available to outer 
the following restriction: the fioating point 
requires 00D4 through OOFF. 


Page 1 

Page 1 is the 6502 hardware stack region; JSR instructions, PHA 
instructions, and interrupts all cause data bytes to be written to 
page 1. Canversely RTS, PLA, and RTI instructions all cause data bytes 
to be read from page 1. The 256 byte stack is adequate for normal 
subroutine calls plus interrupt process nesting, so no restrictions 
have been made on page 1 usage. It is obvious that a stack of this 
size is totally inadequate for deeply recursive processes or for 
nested processes with large local environments to be saved. So, for 
sophisticated applications, Software maintained Stacks must be 
implemented. 

The 6502 stack pointer is initialized at pouier-up or System reset to 
point to location 01FF. The stack then pushes down ward toinard 0100. 

The stack will wrap around from 0100 to 01FF if a stack overflow 
condition occurs, because of the nature of the 6502's 8-bit stack 
pointer register. 


OS Data Base 

Locations 0200 through 047F are allocated by the OS for working 
variables, tables and data buffers. Portions of this region can be 
used only after you determine that nonconflict with the OS 
is guaranteed. For example, the printer and cassette buffers could be 
used if I/O Operations to these devices are impossible within the 
Controlling environment. The amount of work involved in determining 
nonconflict seems to be completely aut of line with the benefits to be 
gained (except for a few trivial cases) and it is recommended that 
pages 2 through 4 not be used except by the OS, 
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User Worfcspace 


Locations 0480 through Q6FF are dedicated for outer enviranment use 
except when the floating point package is used. The -Floating point 
package uses locations Ü57E through 05FF. 


Boot Region 

Page 7 is the start of the "boot region. *' When Software is booted from 
either the diskette or the cassette« it can start at the lowest free 
memorg address (that is 0700) and proceed upward (although it can also 
start at ang address above 0700 and below the screen displag list). 

The top of this region defines the start of the "free memory" region. 
When the boot process is coroplete« a pointer in the data base contains 
the address of the next available location above the Software just 
booted. When no Software has been bootedt this pointer contains the 
value 0700. 


Screen Displag List and Data 

When the OS is handling the screen displag« the displag list that 
defines the screen characteristics and the current data that is 
contained on the screen are placed at the high address end of RAM. The 
bottom of this region defines the end of the free memory region and 
its location is a function of the screen mode currently in effect. A 
pointer in the data base contains the address of the last available 
location below the screen region. 


Free Memorg Region 

The free memory region is all the RAM between the end of the boot 
region and the start of the screen region. The outer level application 
is responsible for managing the free memory region. 


CARTRIDGES A AND B 

There are two 8K regions reserved for plug-in cartridges. Cartridge EL 
that is the right-hand cartridge slot found only in the ATARI 800 
Home Computer« has been allocated memory addresses 8000 
through 9FFF. Cartridge A (the left-hand cartridge slot in the ATARI 
800 Computer console, and the only slot in the ATARI 400 Computer 
console) has been allocated memory addresses AOOO through BFFF and 
optional ly 8000 through BFFF« for l&K cartridges. If a RAM module is 
plugged into the last slot such as to overlay ang of these addresses« 
the RAM takes precedence as long as a cartridge is not inserted. 
However« if a cartridge is inserted« it will disable the entire 
conflicting RAM module in the last slot in 8K increments, 
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MAPPED I/O 


The 6502 perForms input/output operations by addressing the external 
support Chips as memory; some chip registers are read/write while 
others are read-only or write-only (the ATARI Home Computer 
Hardware Manua1 gives descriptions oF all oF the external registers), 
While the entire address space From DOOO to D7FF has been allocated 
For I/O decoding, only the Following subregions are used: 


DOOO-DOIF - CTIA 
D2Ö0-D21F * POKEY 
D300-D31F = PIA 
D4ÖG-D41F = ANTIC 

Figure 4-2. Mapped I/O 


RESIDENT OS AND FLOATING POINT PACKAGE RDM 

The region From D800 through FFFF always contains the GS and the 
Floating point package. Care should be taken to avoid using any entry 
points that are not guaranteed not to move/ to allow For the 
possibility that another, but Functionally compatible. OS can be 
generated in the Future. The OS contains many vectored entry points at 
the end oF the ROM and in RAM that will not move. The Floating point 
package is not vec tored. but all documented entry points will be 
Fixed: Do not use undocumented routines Found by stanning the listing. 
A list oF the Fixed ROM vectors can be Found in Appendix J. 


CENTRAL DATA BASE DESCRIPTION 
See Appendix L. 


MEMORY DYNAMICS 

The Free memory region is the area between the end oF the boot region 
and the start oF the screen region. As such/ its limits are variable. 
MEMLO E02E73 deFines the bottom oF the Free region. and MEMTOP E02E53 
deFines the top oF the region. This section presents the conditions 
that cause the Setup or alteration oF these variables. 
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System Initialization Process 

The OS determines the extent of the lowest block of contlguous RA«, 
and saves the limits. The Screen Editor is then opened, thus setting a 
new (and lower) value in MEMTOP. Diskette or cassette-booted Software 
might be brought into memory, that would probably set a new (and 
higher) value in MEMLQ (see Section 7). MEMLO and «EMTGP will define 
the maximum amount of free memory available when the application 
program finally gets control. That amount of free memory can later 
decrease, as described in the next paragraph. 


Changing Screen «ödes 

The Display Händler interprets the variable APPMHI 'tOOOE!)' to contain 
the address below which MEMTOP cannot extend. This allows you to 
protect the portion of free memory space that you are using from being 
oyerwritten as a result of screen mode change. The display handler 
will set the screen for mode ö, update MEMTOP, and return an error 
Status to you, if it determines that the screen memory will 
extend below APPMHI as a result of a screen mode change. In other 
cases the Display Handler effects the desired mode change and Updates 
MEMTOP. 
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